Skip to content

docs: sharpen messaging and fix terminology#2

Merged
sbroenne merged 1 commit intomainfrom
docs/sharpen-messaging
Feb 12, 2026
Merged

docs: sharpen messaging and fix terminology#2
sbroenne merged 1 commit intomainfrom
docs/sharpen-messaging

Conversation

@sbroenne
Copy link
Owner

Changes

  • Rewrite README with cargo cult programming angle (~400 → ~70 lines)
  • Move code samples to 4 new how-to guides (MCP servers, skills, CLI tools, tool control)
  • Make pytest-aitest a core dependency (not optional)
  • Elevate AI analysis as key feature
  • Broaden messaging to 'Copilot and other coding agents'
  • Fix terminology across 20 files:
    • 'system prompt' → 'instructions'
    • 'sub-agents' → 'custom agents'
    • Remove 'delegation' framing
  • Update analysis prompt template for consistent terminology

Verification

  • \mkdocs build --strict\ passes
  • All 37 unit tests pass

- Rewrite README with cargo cult programming angle
- Slim README from ~400 lines to ~70 lines
- Move code samples to 4 new how-to guides (MCP servers, skills, CLI tools, tool control)
- Make pytest-aitest a core dependency (not optional)
- Elevate AI analysis as key feature
- Broaden messaging to 'Copilot and other coding agents'
- Fix terminology: 'system prompt' -> 'instructions', 'sub-agents' -> 'custom agents'
- Remove 'delegation' framing from custom agent docs/tests
- Update analysis prompt template for consistent terminology
@github-actions
Copy link

Dependency Review

The following issues were found:
  • ✅ 0 vulnerable package(s)
  • ✅ 0 package(s) with incompatible licenses
  • ✅ 0 package(s) with invalid SPDX license definitions
  • ⚠️ 1 package(s) with unknown licenses.
See the Details below.

License Issues

pyproject.toml

PackageVersionLicenseIssue Type
pytest-aitest>= 0.2.9NullUnknown License

OpenSSF Scorecard

PackageVersionScoreDetails
pip/pytest-aitest >= 0.2.9 UnknownUnknown

Scanned Files

  • pyproject.toml

@sbroenne sbroenne merged commit a07576f into main Feb 12, 2026
8 checks passed
@sbroenne sbroenne deleted the docs/sharpen-messaging branch February 12, 2026 00:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant